Метод IDataset::Edit

Переводит текущую запись набора данных в режим редактирования.

IDL

[id(103432)]
HRESULT Edit(
    [out, retval] VARIANT_BOOL* Value
);

Параметры

Параметры	Описание
Value	Возвращаемое значение

Возвращаемое значение

"True", если перевод записи в режим редактирования выполнен успешно.

Описание

Переводит текущую запись набора данных в режим редактирования по следующему алгоритму:

№	Описание
1.	Если набор данных пустой (значение свойства IDataset::IsEmpty равно "True"), то вызывает метод IDataset::Append и возвращает результат выполнения данного метода.
2.	Если набор данных находится в состоянии редактирования или добавления записи, то метод завершает работу и возвращает результат "True".
3.	Если у текущего пользователя есть права на изменение записи (значение свойства IDataset::CanEdit равно "True"), то вызывает событие IDatasetEvents::OnDatasetBeforeEdit. Иначе метод завершает работу и возвращает результат "False".
4.	Если в событии IDatasetEvents::OnDatasetBeforeEdit редактирование записи не было отменено, то метод переводит набор данных в состояние редактирования текущей записи (свойству IDataset::State устанавливает значение "dstEdit").
5.	Вызывает событие IDatasetEvents::OnDatasetAfterEdit.
6.	Возвращает "True", если перевод записи в режим редактирования выполнен успешно. Иначе возвращает "False".